home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / printer / 2col41c.zip / 2COL.DOC < prev    next >
Text File  |  1992-11-10  |  25KB  |  636 lines
  1.                                  2col
  2.  
  3.                          Shareware Version 4.1
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                             Copyright 1992
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19.  
  20. YE OLDE DISCLAIMER
  21.  
  22.   This software and manual are sold "as is" and without warranties
  23.   as to performance or merchantability or any other warranties
  24.   whether expressed or implied. Because of the various hardware and
  25.   software environments into which this program may be put, no
  26.   warranty of fitness for a particular purpose is offered. The user
  27.   must assume the entire risk of using and evaluating this program.
  28.   Any liability of the seller will be limited exclusively to product
  29.   replacement or refund of purchase price.
  30.  
  31.  
  32.  
  33. Introduction
  34.  
  35.   2col prints an ASCII text file in two columns,each up to 80
  36.   characters wide, on standard width paper. It eliminates
  37.   consecutive blank lines and prints at 20 characters/inch.
  38.  
  39.   2col now supports Deskjet printers as well as dot matrix printers.
  40.   See the insructions for using the -J option when running on a
  41.   Deskjet printer. You must always use the -J option with a Deskjet.
  42.  
  43.   2col is designed to be extremely easy to use. The default settings
  44.   will accommodate most printing needs. On most  9-pin printers
  45.   you can print a document by simply typing: 2COL [filename] <enter>
  46.   For example, to print this manual type:2COL 2COL.DOC <enter>
  47.   On 24-pin printers you must also include -Q on the command line.
  48.   To see a demonstration of 2COL's many print modes you can
  49.   type: DEMO2COL [9, 24, or J] <enter>. If your printer cannot print
  50.   20 char/in you should include -W68 on the command line.
  51.  
  52.   2col is intended to greatly reduce the huge volume of paper that
  53.   results from printing reference manuals and text files. Regular
  54.   use of this program should cut your paper bill by 60 to 70
  55.   percent. It provides excellent readability (unlike other
  56.   compressed print programs) while compressing an average of
  57.   four pages of source material onto one side of a sheet of
  58.   paper. By using its even/odd alternate side print feature eight
  59.   pages of text can be printed using both sides of a page. Since the
  60.   normal draft mode of printing can be used, it is also much faster
  61.   than those programs which rely on nonstandard print modes.
  62.  
  63.   By reducing the volume of paper, 2col also reduces storage
  64.   requirements and the bulk one has to carry around when traveling.
  65.   It can also save you money when faxing or mailing documents.
  66.  
  67.   As a side benefit, many 2col users actually find it easier and
  68.   faster to read the compressed versions than the originals because
  69.   they can take in more words at one time without having to scan
  70.   across the page.
  71.  
  72.   2col will optionally print in subscript mode - doubling the amount
  73.   of text contained on a single sheet to a total of sixteen pages -
  74.   with a significant loss in legibility and printing speed. This
  75.   mode is intended mainly for archival use not for documents that
  76.   will be read frequently.
  77.  
  78.   This program will work on most Epson-compatible dot-matrix
  79.   printers which provide 17 characters/inch compressed printing but
  80.   is especially intended for newer printers which have a
  81.   compressed/elite mode (20 char/in) allowing two complete 80
  82.   character lines to be printed across the page. Printers which
  83.   support 20 char/inch include:KXP1180, KXP1124, FX86, 200GX,
  84.   LQ-series, etc. If you have a 17 char/inch printer see the
  85.   registration section below about obtaining a word-wrap utility.
  86.  
  87.   Since most printers do not show the 20 char/inch mode on the front
  88.   panel, you should check the manual or just try printing with 2col.
  89.   If your printer supports 20 char/in but does not operate properly
  90.   with 2col, contact me, and I will let you know if it is possible
  91.   to provide you with an updated version that is compatible with
  92.   your printer.
  93.  
  94.  
  95. IMPORTANT!
  96.  
  97.   DOT MATRIX:
  98.   The 20 char/in mode on many printers cannot be accessed by
  99.   software if the DIP switches inside the printer are set for IBM
  100.   mode. The printer MUST be set for the Epson/Standard mode. 2col
  101.   will optionally supply the control characters to cause the full
  102.   IBM character set to print. Also, your printer should have the
  103.   auto linefeed switch turned off. If your printer has a front panel
  104.   pitch control, it should be set to program mode. On most printers
  105.   it is okay to set a specific font from the front panel as long as
  106.   the pitch is left in program mode.
  107.  
  108.   DESKJET:
  109.   If you have previously been printing standard size characters with
  110.   perf skip on, you must push the reset button on your printer
  111.   immediately before printing with 2COL or use the -J1 option.
  112.   Otherwise, the first page will not print correctly. Also, -W68 and
  113.   -W67 may truncate lines on the Deskjet because of its 16.67
  114.   cpi font pitch.
  115.  
  116.  
  117. Hints
  118.  
  119.   Since 24-pin printers tend to print a taller font than 9-pin
  120.   printers, both in subscript mode and standard, it is advisable to
  121.   use fewer lines/page with 24-pin printers to get optimum
  122.   readablity and appearance.
  123.  
  124.   Since 2COL does not issue any font selection commands, the last
  125.   font selected for your printer will be the one used. Fonts may be
  126.   selected via the printer control panel or by a printer control
  127.   program. At 20 characters/inch the most readable font (and the
  128.   fastest) is usually the standard draft font. Letter quality fonts
  129.   tend to be too "busy" for good compressed printing.
  130.  
  131.   2COL does issue a printer reset when it finishes and if the font
  132.   you selected is not your default font, it may need to be
  133.   reselected before printing again.
  134.  
  135.   You will find it most convenient to use 2COL if you install it in
  136.   a directory which is located in your PATH statement. See your DOS
  137.   manual for more information.
  138.  
  139.   When using a Deskjet you will probably want to use a top margin of
  140.   -F4. Also, try selecting the draft mode on the printer's control
  141.   panel. You may find it adequate for 2COL printing.
  142.  
  143. Registration
  144.  
  145.   I will keep improving the program if I know enough people are
  146.   finding it useful.
  147.  
  148.   My registration policy is very flexible. The nominal fee is $20 US
  149.   If you don't feel you will get $20 worth of use out of 2COL, send
  150.   whatever it is worth to you. If you are impoverished and can't
  151.   afford to pay anything, enclose a stamped self-addressed envelope
  152.   and I will send you a registration.
  153.  
  154.   This is not freeware or public domain. Shareware is simply a means
  155.   of marketing commercial software. You are required to register if
  156.   you intend to use this program after a reasonable trial period.
  157.  
  158.   When registering, please tell me the version number you have, your
  159.   printer model, and where you obtained your copy of 2col.
  160.   Registration checks should be made payable to "Tony Caine".
  161.  
  162.   2col should be registered for the maximum number of copies that
  163.   can be used simultaneously at your site. Site fees for commercial
  164.   users can be negotiated.
  165.  
  166.   If you register for the full $20 fee, and enclose a Shipping and
  167.   Handling fee of $4.95 I will send you the latest versions of 2COL
  168.   and JETCOL (for lasers). JETCOL requires a separate registration
  169.   fee if you decide to use it after a trial period. I will also send
  170.   other printing related shareware programs including a word wrap
  171.   program (by another author) which can be used to expand or
  172.   contract the column width of documents before printing. This is
  173.   particularly useful for those with 17 char/inch printers which
  174.   cannot print two full 80 character columns. The shareware word
  175.   wrap program requires a $10 registration fee if used past 30 days.
  176.  
  177.  
  178. Registered version features
  179.  
  180.  
  181.  
  182. * Custom default settings
  183.  
  184.    2COL's default settings can be modified by the user. This
  185.    eliminates the need for the user to enter a string of options
  186.    whenever they run the program. They need only enter the filename.
  187.  
  188.  
  189. * Automargin
  190.  
  191.    The automargin option is extremely useful for those who need to
  192.    punch holes for binding. 2col scans the entire document before
  193.    printing and, in effect, moves all the available "white space"
  194.    from the center (and, if necessary,from the right margin) of the
  195.    document to the left margin.
  196.  
  197.    To get an idea of how Automargin operates, type: 2COL 2COL.DOC
  198.    <enter>. This will print with the default settings of 2col. Then
  199.    type: 2COL 2COL.DOC -K -U8 <enter>. This will print a one page
  200.    demo using automargin.
  201.  
  202.  
  203. * Multiple document names
  204.  
  205.    Multiple document names and wildcards can be entered on the
  206.    command line.
  207.  
  208.  
  209. * Append
  210.  
  211.    When specifying multiple documents to print, registered users
  212.    have the choice of starting each file at the beginning of a page
  213.    or treating all documents as one continuous file without breaks.
  214.  
  215.  
  216. * Redirection of output
  217.  
  218.    Registered users can choose to send the output to a disk file for
  219.    later printing in background (while running other programs) or
  220.    they can send to LPT2, COM1, COM2, etc.
  221.  
  222.  
  223. * Pagefix
  224.  
  225.    Prints a specified number of pages per column retaining original
  226.    line spacing and page breaks.
  227.  
  228.  
  229. * The registration screen is eliminated, of course.
  230.  
  231.  
  232.  
  233. Terminology
  234.  
  235.   Since several pages from the original source file are combined
  236.   onto a single page of printer output, there may be some confusion
  237.   about the word "page." We will always refer to the original
  238.   document pages as "source pages." What is actually printed will
  239.   simply be called "pages."
  240.  
  241.  
  242.  
  243. Usage:
  244.  
  245.   2col  [options] path\filename [options] [path\filename]...
  246.  
  247.  
  248.   Options (except -Yx) may be specified in any order before and/or
  249.   after the file name(s). Options MUST be separated from each other
  250.   by spaces and preceded by a "-". Upper and lower case are
  251.   interchangeable.
  252.  
  253.  
  254.  
  255.  
  256.   Options are defined as follows:
  257.  
  258.    -Lxx = Each column will be xx lines long
  259.    -Cxx = No more than xx consecutive blank lines will be printed
  260.    -Sxx = Skip xx pages before starting to print
  261.    -O   = Print only odd # pages
  262.    -E   = Print only even # pages
  263.    -Wxx = column width (number of characters in each column)
  264.    -P   = Pause before printing each page.
  265.    -N   = Prints filename and page # at lower left corner
  266.    -D   = Delimit each (source) page with a line and page #
  267.    -T   = Truncate long lines instead of wrap.
  268.    -G   = Enable full IBM graphics set.(dot matrix only)
  269.    -Fx  = Put a margin of x blank lines at the top of each page.
  270.    -K   = Print a one page demo in registered mode.
  271.  * -Mx  = Set left margin.(CAUTION:READ INSTRUCTIONS BEFORE USING)*
  272.    -?   = 2COL will ask for filenames to print.
  273.    -Q   = 24-pin printer line spacing
  274.    -Jx  = Deskjet mode
  275.    -V   = Report # of pages to print.
  276.    ?    = (no dash) Prints help screen. Must be the only option.
  277.  
  278.                 *Options for registered users only*
  279.  
  280.    -A   = Append multiple files.
  281.    -Z   = Route output to disk.
  282.    -Ux  = Scans file before printing and sets margins automatically.
  283.    -Xx  = Print x pages/column preserving page breaks & format
  284.    -Yx  = Customize 2COL default settings.
  285.  
  286.  
  287.   When more than 102 lines/page requested,shifts to subscript
  288.   (half-height) mode. When column width is less than 69 chars,uses
  289.   compressed mode (17 char/in.) When column width is greater than
  290.   68 uses compressed/elite (20 char/in.)
  291.  
  292.   Defaults: 80 characters/column;88 lines/page;1 consecutive blank
  293.            line; no pause before printing page; do not number pages;
  294.            wrap (not truncate) long lines;0 blank lines at top of
  295.            page.
  296.  
  297.  
  298. Description of options
  299.  
  300.  
  301.    -Lxxx
  302.  
  303.       Each column will contain xxx lines of data. Line spacing will
  304.       be automatically adjusted to approximately fill the page.
  305.       Characters will be normal (pica) height until more than 102
  306.       lines/column are specified; printer will then shift to
  307.       subscript mode allowing up to 220 lines/column. Default value
  308.       is 88.
  309.  
  310.  
  311.     -Cxx
  312.  
  313.       Pages of text frequently contain many blank lines of data.
  314.       Experience has shown that most of these can be discarded
  315.       without sacrificing readability. This option specifies that
  316.       when there are more than xx consecutive blank lines, the
  317.       excess will be discarded. If you set xx=66, 2col will print
  318.       each page in its original format without discarding any blank
  319.       lines. The default value is 1.
  320.  
  321.  
  322.     -Sxx
  323.  
  324.       This feature is useful if you have a paper jam or decide to
  325.       print part now and part later. Using this option will cause xx
  326.       pages to be skipped before printing begins. For example,
  327.       specifying "-S2" will cause printing to begin with page 3.
  328.       When using the -O or -E option remember to count all pages -
  329.       odd and even.
  330.  
  331.  
  332.     -O
  333.  
  334.       This and the -E option allow you to print on both sides of
  335.       each sheet of paper. By specifying "-O", only the odd numbered
  336.       pages will be printed. When printing is complete,reload the
  337.       first page back into the printer with the blank side facing
  338.       the print head and rerun 2col using the -E option.
  339.  
  340.       Alternatively, 2COL will ask you whether you want to print the
  341.       even pages after it has finished printing the odd. Respond "Y"
  342.       after the paper has been reloaded or type "X" to terminate.
  343.  
  344.     -E
  345.  
  346.       Prints only even numbered pages. When using this option after
  347.       the -O option be sure to shift the paper about 1/2 inch to the
  348.       right before starting to print, to allow space for hole
  349.       punching or other binding requirements.
  350.  
  351.  
  352.     -Wxx
  353.  
  354.       This option specifies how wide each column will be. Wrapping
  355.       or truncating will begin at this position. It also determines
  356.       the print density. If xx is 68 or less, the printer will use
  357.       compressed mode (137 characters across the page). If xx is 69
  358.       or larger the printer will use compressed/elite (160
  359.       characters/line). If your printer does not support
  360.       compressed/elite and you try to use it, you will end up with a
  361.       mess. You should then specify xx as 68 and decide whether you
  362.       want to truncate long lines or wrap them. Since 2COL wraps
  363.       in mid-word line by line and does not reformat, you might want
  364.       to obtain a shareware word wrapping program. I can supply
  365.       one when you register. See the "registration" section of
  366.       this document for details.
  367.  
  368.  
  369.     -P
  370.  
  371.       Program will pause before printing each page. Hit any key to
  372.       print a page. This option is useful if you are feeding single
  373.       sheets to the printer.
  374.  
  375.  
  376.     -Nx
  377.  
  378.       This will cause the filename and page number to be printed in
  379.       the lower left-hand corner of each sheet. To avoid confusion
  380.       when using the -S, -O and -E options the page numbering is not
  381.       reset for each document when multiple documents are specified
  382.       on the command line(registered version only).
  383.  
  384.       If x=2 the current date will also be printed. If x=1 or blank
  385.       only the filename and page number will be printed.
  386.  
  387.  
  388.     -D
  389.  
  390.       If you need to keep track of each source page, this option
  391.       will print a dashed line with a page number in the middle
  392.       whenever a form feed is encountered or after 66 lines of data.
  393.       Experience has shown that this option will be rarely used
  394.       because most documents either number their own pages or it is
  395.       just not important to keep track of original page breaks.
  396.  
  397.  
  398.     -T
  399.  
  400.       Normally when lines longer than the specified column width are
  401.       encountered, 2col will wrap the data to the next line. If you
  402.       prefer to truncate or discard excess characters on a line, you
  403.       should invoke this option.
  404.  
  405.  
  406.  
  407.     -G
  408.  
  409.       Sends control codes to enable full IBM graphics set (ASCII
  410.       128-255). The graphics set includes line drawing characters
  411.       and foreign alphabets. This function is not for DeskJet.
  412.  
  413.  
  414.  
  415.  
  416.     -Fx
  417.  
  418.       2col will insert x blank lines at the top of each page before
  419.       printing. The default is 0.
  420.  
  421.  
  422.     -Mx
  423.  
  424.       CAUTION: IMPROPER USE OF THIS OPTION WILL CAUSE YOUR PRINTER
  425.       TO PRINT PAST THE BOTTOM OF THE PAGE.
  426.  
  427.       This command sets the left margin x spaces from the edge of
  428.       the page. Default is 0. Use this option with caution! Most
  429.       standard width printers only have 160 print positions across
  430.       the page. If you insert spaces with a margin command, the
  431.       printer will wrap characters that go past the 160th print
  432.       position to the left side of the page, causing  extra lines
  433.       to be inserted. If you use a left margin of 5, for example,
  434.       you might have to set the column width to -W77 to prevent
  435.       wraparound (this is only necessary if printable characters
  436.       would be pushed past the 160th column- blanks don't matter).
  437.  
  438.       The easiest way to achieve a left margin without having to
  439.       worry about characters wrapping is to use the Automargin
  440.       option (-Ux) described below.
  441.  
  442.       Given the limitations of standard width printers, it is
  443.       suggested that you permanently shift your paper several spaces
  444.       to the left. You can adjust your word processor margin
  445.       settings to compensate, so that normal printing will be
  446.       unaffected.
  447.  
  448.  
  449.     -K
  450.  
  451.       Including this option on the command line allows any
  452.       registered option listed below to be used, but only for a
  453.       one page demo. This option allows you to explore the
  454.       options available to registered users.
  455.  
  456.  
  457.     -?
  458.  
  459.       Instructs 2COL to ask for files to print once it is running.
  460.       You can specify files both on the command line and when 2COL
  461.       asks for filenames. Separate the file names with spaces. This
  462.       option is useful when 2COL is run from a menu or a Windows
  463.       icon.
  464.  
  465.  
  466.     -Q
  467.  
  468.       Adjusts line spacing for 24-pin printers. If you have a 24-pin
  469.       printer and do not use this option, pages will print too long.
  470.  
  471.     -Jx
  472.  
  473.       Use this option whenever you are using a Deskjet printer.
  474.  
  475.       If x=0 or blank, 2col will not eject a page before printing.
  476.       You can use this option if you have just printed with 2COL or
  477.       if perf skip was not activated. If you have previously been
  478.       printing with perf skip on, you must either push the reset
  479.       button on the printer before running 2col or use -J1.
  480.  
  481.     -V
  482.  
  483.       This option prescans the document and tells you many pages
  484.       (odd+even) will print. If you are printing only odd or even,
  485.       you must divide by two.
  486.  
  487.       ***Options below are only in the registered version of 2col***
  488.  
  489.  
  490.  
  491.     -Yx
  492.  
  493.       The -Y option allows you to modify 2COL's default settings.
  494.       This MUST always be the first option on the command line
  495.       whenever you use it.
  496.  
  497.       Typing "2COL -Y1 <enter>" will cause 2COL to display all
  498.       current default settings.
  499.  
  500.       Typing "2COL -Y2 [options....] <enter>" will cause 2COL to
  501.       permanently remember those options by modifying the 2COL.EXE
  502.       program itself. Your personal registration code MUST always be
  503.       one of the options specified whenever you modify the default
  504.       settings. Whenever the -Y2 option is used, any options not
  505.       specified on the command line will be reset to the standard
  506.       defaults. Therefore, even if you change only one of your
  507.       custom options, you must reenter them all at the same time.
  508.       The next time you run 2COL the options you specified will
  509.       automatically be used.
  510.  
  511.       For example, if you want to set the number of lines/page to
  512.       102 and print the page numbers at the bottom, you would type:
  513.       2COL -Y2 -L102 -N registration code# <enter>. The next time
  514.       you type 2COL [filename] <enter> It would be as though you had
  515.       typed: 2COL -L102 -N registration code [filename].
  516.  
  517.       If there are several different option profiles you wish to
  518.       use, you can create different copies of 2COL.EXE with
  519.       different names, such as 2COL1.EXE, 2COL2.EXE, etc. The -Y2
  520.       option only modifies the EXE file having the same name and
  521.       path that you type on the command line.
  522.  
  523.       All defaults with an 'x' value can be temporarily overridden
  524.       with a different value on the commmand line. Use an 'x' value
  525.       of 0 to temporarily deactivate Automargin or Pagefix. Any
  526.       option without an 'x' value can be activated by simply putting
  527.       it on the command line. To temporarily deactivate an option
  528.       set as a permanent default, type a minus after the option. For
  529.       example, to temporarily deactivate the N option, you would put
  530.       -N- on the command line: 2COL -N- [filename]
  531.  
  532.       THIS FUNCTION WILL NOT WORK ON .EXE FILES THAT HAVE BEEN
  533.       COMPRESSED WITH PKLITE. You must first decompress, use the -Y2
  534.       option and then recompress.
  535.  
  536.  
  537.     -A
  538.  
  539.       When multiple files are specified on the command line
  540.       (registered version only) you have the option of either
  541.       starting a new page for each file (default) or appending them
  542.       as though they were one continuous file. The -A option causes
  543.       them to be appended.
  544.  
  545.  
  546.     -Ux
  547.  
  548.       The aUtomargin function allows you to obtain as much margin as
  549.       possible according to the format of the document. 2col scans
  550.       the entire document before printing and adjusts the column
  551.       width to gain as much space on the print line as possible.
  552.       The space obtained is allocated to the left margin until the x
  553.       value you entered is reached. The remaining space, if any, is
  554.       then added to the right margin.
  555.  
  556.       If you have specified the -E option (to print on the reverse
  557.       side of the page), the first available space is used to create
  558.       a right margin (for binding) rather than a left margin.
  559.  
  560.  
  561.     -Zfilename
  562.  
  563.       Allows output to be routed to a file instead of to the
  564.       printer. The file can then be printed in background while
  565.       running other programs. For example, to send output to a file
  566.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  567.       command line.If PRINT.TXT does not exist, it will be created.
  568.       If PRINT.TXT already exists, 2col output will be appended to
  569.       the end of the file. This command is only active in the
  570.       registered version of 2col. This option can also be used to
  571.       redirect output to LPT2, COM1, COM2, etc.
  572.  
  573.  
  574.     -Xx
  575.  
  576.       Prints exactly x pages in each column preserving original page
  577.       breaks and not suppressing consecutive blank lines. Thus the
  578.       original page formatting is maintained. Allowed range of x
  579.       is 1-3.
  580.                          -X option page formats:
  581.  
  582.              x=1                  x=2               x=3
  583.  
  584.            111 222              111 333           111 444
  585.            111 222              111 333           111 444
  586.            111 222              111 333
  587.            111 222                                222 555
  588.            111 222                                222 555
  589.            111 222              222 444
  590.            111 222              222 444           333 666
  591.            111 222              222 444           333 666
  592.  
  593.  
  594.  
  595. Examples:
  596.  
  597. 2COL 2COL.DOC -L102 <enter>  will print 102 lines/column
  598.  
  599. 2COL 2COL.DOC -L102 -N will print 102 lines/column and number pages.
  600.  
  601. 2COL 2COL.DOC -G -N  will number pages and enable IBM graphics set.
  602.  
  603.  
  604.  
  605.  
  606. Using 2COL with a word processor
  607.  
  608.     2COL will not work with most word processor documents in their
  609.     original form; but most word processors have what is called an
  610.     ASCII output or DOS output mode which 2COL will work with.
  611.  
  612.     For example, with WordPerfect, you can create a 2COL usable
  613.     file with the sequence: Control-F5,1,Save.
  614.  
  615.  
  616.  
  617. Distribution
  618.  
  619.     Permission is hereby given to copy and distribute this program
  620.     as long as no fee other than a minimal ( <$10 ) handling cost is
  621.     charged. It must be made clear to the buyer that this is only a
  622.     handling charge and not a registration fee.Please include all
  623.     files in their original unmodified form when distributing this
  624.     program. Permission to distribute may be revoked by the author
  625.     at any time for any reason.
  626.  
  627.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  628.     A REGISTRATION CODE. A program can be unbranded by typing
  629.     2COL -Y2 <enter>.
  630.  
  631.  
  632.  
  633.                                                      -Tony Caine-
  634.  
  635. GEnie mail:A.CAINE
  636.